<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>Proc::Background - Generic interface to Unix and Win32 background process management - metacpan.org</title>
        <link rel="preload" as="fetch" href="https://metacpan.org/account/login_status" crossorigin="anonymous" />
        <link href="https://metacpan.org/_assets/b8ccceeed47a0652049703d99326a9cea4933443.css" rel="stylesheet" type="text/css">
        <script src="https://metacpan.org/_assets/6bfedafe2d7caa915b7d84f61b45936818e3242e.js" type="text/javascript" defer></script>
        <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of Proc-Background - MetaCPAN" href="https://metacpan.org/dist/Proc-Background/releases.rss" />
        <link rel="canonical" href="./Proc::Background.html" />
        <meta name="description" content="Generic interface to Unix and Win32 background process management" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5">
        <link rel="shortcut icon" href="https://metacpan.org/static/icons/favicon.ico">
        <link rel="apple-touch-icon" sizes="152x152" href="https://metacpan.org/static/icons/apple-touch-icon.png">
        <link rel="search" href="https://metacpan.org/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN">
        <script>
          (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
          (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
          })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

          (function(skey, ga_id){
            ga('create', ga_id, {
              siteSpeedSampleRate : 100,
              storage             : 'none',
              clientId            : localStorage.getItem(skey)
            });
            ga(function(tracker) {
              localStorage.setItem(skey, tracker.get('clientId'));
            });
            ga('send', 'pageview');
          })('ga:clientId', 'UA-27829474-1');
        </script>
<meta name="twitter:card"        content="summary" />
<meta name="twitter:url"         content="https://metacpan.org/pod/Proc::Background" />
<meta name="twitter:title"       content="Proc::Background" />
<meta name="twitter:description" content="Generic interface to Unix and Win32 background process management" />
<meta name="twitter:site"        content="metacpan" />
    </head>
    <body>
        <nav class="navbar navbar-default" role="navigation">
            <div class="header-logo-large hidden-xs">
              <a href="https://metacpan.org/" tabindex="0">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#logo" />
                </svg>
              </a>
            </div>
            <div class="header-logo-icon visible-xs">
              <a href="https://metacpan.org/">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#dots" />
                </svg>
              </a>
            </div>
            <ul class="nav navbar-nav menu-items hidden-xs hidden-sm">
              <li><a href="https://metacpan.org/about">About</a></li>
              <li><a href="https://metacpan.org/about/sponsors">Sponsor</a></li>
              <li><a href="https://grep.metacpan.org/">grep::cpan</a></li>
              <li><a href="https://metacpan.org/recent">Recent</a></li>
              <li><a href="https://metacpan.org/about/faq">FAQ</a></li>
              <li><a href="https://metacpan.org/tools">Tools</a></li>
              <li><a href="https://fastapi.metacpan.org/">API</a></li>
            </ul>
            <ul class="nav navbar-nav navbar-right">
                <button type="button" class="searchbar-btn visible-xs visible-sm">
                    <i class="fa fa-search button-fa-icon"></i>
                </button>
                <form action="https://metacpan.org/search" class="searchbar-form visible-md visible-lg search-form form-horizontal">
                   <input type="hidden" name="size" id="metacpan_search-size" value="20">
                  <div class="form-group">
                      <div class="search-group">
                        <i class="fa fa-search"></i>
                        <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value="">
                      </div>
                  </div>
                </form>
                    <li class="icon-slidepanel visible-xs visible-sm">
                      <button data-toggle="slidepanel" data-target=".slidepanel">
                        <span class="button-fa-icon">
                          <i class="fa fa-bars slidepanel-open"></i>
                          <i class="fa fa-times slidepanel-close"></i>
                        </span>
                      </button>
                    </li>
                <form action="https://metacpan.org/account/logout" method="POST" id="metacpan-logout"></form>
                <li class="dropdown logged_in" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li><a href="https://metacpan.org/account/identities">Identities</a></li>
                        <li><a href="https://metacpan.org/account/profile">Profile</a></li>
                        <li><a href="https://metacpan.org/account/favorite/list">Favorites</a></li>
                        <li>
                            <a href="./Proc::Background.html#" type="button" onclick="$('#metacpan-logout').submit(); return false">
                              Logout
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_out" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li>
                            <a href="https://metacpan.org/login/github">
                                <i class="fab fa-github fa-fw"></i>
                                GitHub
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/twitter">
                                <i class="fab fa-twitter fa-fw"></i>
                                Twitter
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/google">
                                <i class="fab fa-google fa-fw"></i>
                                Google
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_placeholder">
                    <button>
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                    </button>
                </li>
            </ul>
        </nav>
        <div class="page-content ">
          <!--
          <div class="top-notify-banner">
            <i class="fas fa-info-circle"></i>
          </div>
          -->
          <nav class="sidebar">
            <div class="slidepanel">
              <ul class="nav-list ">
    <li class="nav-header no-margin-top">
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of Proc-Background was released.">
      <span class="relatize">22 Apr 2023 21:30:00 UTC</span>
    </li>
  <li>
    Distribution: <a href="https://metacpan.org/dist/Proc-Background">Proc-Background</a>
  </li>
  <li>
    Module version: 1.32
  </li>
  <li>
    <a data-keyboard-shortcut="g s" href="https://metacpan.org/dist/Proc-Background/source/lib/Proc/Background.pm">Source</a>
    (<a href="https://metacpan.org/dist/Proc-Background/source/lib/Proc/Background.pm?raw=1">raw</a>)
  </li>
  <li>
    <a data-keyboard-shortcut="g b" href="https://metacpan.org/dist/Proc-Background/source/lib/Proc">Browse</a>
    (<a href="https://metacpan.org/dist/Proc-Background/source/lib/Proc?raw=1">raw</a>)
  </li>
    <li>
      <a data-keyboard-shortcut="g c" href="https://metacpan.org/dist/Proc-Background/changes">Changes</a>
    </li>
    <li>
      <a class="nopopup" href="https://metacpan.org/dist/Proc-Background/contribute">How to Contribute</a>
    </li>
    <li>
        <a rel="noopener nofollow" data-keyboard-shortcut="g r" href="https://github.com/nrdvana/perl-proc-background">Repository</a>
    </li>
    <li>
      <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://github.com/nrdvana/perl-proc-background/issues">Issues</a>
      (2)
    </li>
    <li>
      <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=Proc-Background+1.32" title="Matrix">Testers</a>
        <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/P/Proc-Background.html?oncpan=1&amp;distmat=1&amp;version=1.32&amp;grade=2" style="color: #090">993</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/P/Proc-Background.html?oncpan=1&amp;distmat=1&amp;version=1.32&amp;grade=3" style="color: #900">1</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/P/Proc-Background.html?oncpan=1&amp;distmat=1&amp;version=1.32&amp;grade=4">0</a>)</span>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/NERDVANA/Proc-Background-1.32">Kwalitee</a>
    </li>
    <li>
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on Proc-Background who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)">
      Bus factor: 1
      </div>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpancover.com/latest/Proc-Background-1.32/index.html">70.05% Coverage </a>
    </li>
    <li>
      License: perl_5
    </li>
    <li class="nav-header">Activity</li>
    <li>
<div class="activity-graph">
    <img src="https://metacpan.org/dist/Proc-Background/activity.svg?res=month" />
    <div class="comment">24 month</div>
</div>
    </li>
    <li class="nav-header">Tools</li>
    <li>
      <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/N/NE/NERDVANA/Proc-Background-1.32.tar.gz">
      Download (<span itemprop="fileSize">32.83KB</span>)</a>
    </li>
    <li>
      <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FNERDVANA%2FProc-Background-1.32%2Flib%2FProc%2FBackground.pm">
        MetaCPAN Explorer
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Proc-Background/permissions">
        Permissions
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Proc-Background/releases.rss">
        Subscribe to distribution
      </a>
    </li>
    <li>
      <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog">
        Install Instructions
      </button>
    </li>
    <li>
      <form action="https://metacpan.org/search">
        <input type="hidden" name="q" value="dist:Proc-Background">
        <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
      </form>
    </li>
    <li>
      <form action="https://grep.metacpan.org/search">
        <input type="hidden" name="qd" value="Proc-Background">
        <input type="hidden" name="source" value="metacpan">
        <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
     </form>
    </li>
    <li class="version-jump">
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/lib/Proc/Background.pm&#39;" class="form-control tool-bar-form">
  <option disabled selected>Jump to version</option>
<option
  disabled
  value="NERDVANA/Proc-Background-1.32"
>1.32
  (NERDVANA on 2023-04-22)</option>
<option
  
  value="NERDVANA/Proc-Background-1.31"
>1.31
  (NERDVANA on 2023-04-17)</option>
<option
  
  value="NERDVANA/Proc-Background-1.30"
>1.30
  (NERDVANA on 2021-10-21)</option>
<option
  
  value="NERDVANA/Proc-Background-1.22"
>1.22
  (NERDVANA on 2021-07-10)</option>
<option
  
  value="BZAJAC/Proc-Background-1.10"
>1.10
  (BZAJAC on 2009-07-05)</option>
<option
  
  value="BZAJAC/Proc-Background-1.09"
>1.09
  (BZAJAC on 2009-07-02)</option>
<option
  
  value="BZAJAC/Proc-Background-1.08"
>1.08
  (BZAJAC on 2002-12-07)</option>
<optgroup label="BackPAN">'
<option
  
  value="NERDVANA/Proc-Background-1.29_02"
>1.29_02 DEV
  (NERDVANA on 2021-10-20)</option>
<option
  
  value="NERDVANA/Proc-Background-1.29_01"
>1.29_01 DEV
  (NERDVANA on 2021-10-20)</option>
<option
  
  value="NERDVANA/Proc-Background-1.21"
>1.21
  (NERDVANA on 2019-11-05)</option>
<option
  
  value="NERDVANA/Proc-Background-1.20"
>1.20
  (NERDVANA on 2019-11-04)</option>
<option
  
  value="BZAJAC/Proc-Background-1.07"
>1.07
  (BZAJAC on 2002-04-21)</option>
<option
  
  value="BZAJAC/Proc-Background-1.06"
>1.06
  (BZAJAC on 2001-09-08)</option>
<option
  
  value="BZAJAC/Proc-Background-1.05"
>1.05
  (BZAJAC on 2001-08-28)</option>
<option
  
  value="BZAJAC/Proc-Background-1.04"
>1.04
  (BZAJAC on 2001-08-16)</option>
<option
  
  value="BZAJAC/Proc-Background-1.03"
>1.03
  (BZAJAC on 2001-02-04)</option>
<option
  
  value="BZAJAC/Proc-Background-1.02"
>1.02
  (BZAJAC on 2001-01-23)</option>
<option
  
  value="BZAJAC/Proc-Background-1.01"
>1.01
  (BZAJAC on 2000-06-21)</option>
<option
  
  value="BZAJAC/Proc-Background-1.00"
>1.00
  (BZAJAC on 2000-04-20)</option>
<option
  
  value="BZAJAC/Proc-Background-0.03"
>0.03
  (BZAJAC on 2000-04-20)</option>
<option
  
  value="BZAJAC/Proc-Background-0.02"
>0.02
  (BZAJAC on 1998-06-28)</option>
<option
  
  value="BZAJAC/Proc-Background-0.01"
>0.01
  (BZAJAC on 1998-06-17)</option>
</optgroup>
</select>
    </li>
    <li class="version-diff">
<select onchange="document.location.href='/release/NERDVANA/Proc-Background-1.32/diff/' + encodeURIComponent(this.value) + '/lib/Proc/Background.pm'
" class="form-control tool-bar-form">
  <option disabled selected>Diff with version</option>
<option
  disabled
  value="NERDVANA/Proc-Background-1.32"
>1.32
  (NERDVANA on 2023-04-22)</option>
<option
  
  value="NERDVANA/Proc-Background-1.31"
>1.31
  (NERDVANA on 2023-04-17)</option>
<option
  
  value="NERDVANA/Proc-Background-1.30"
>1.30
  (NERDVANA on 2021-10-21)</option>
<option
  
  value="NERDVANA/Proc-Background-1.22"
>1.22
  (NERDVANA on 2021-07-10)</option>
<option
  
  value="BZAJAC/Proc-Background-1.10"
>1.10
  (BZAJAC on 2009-07-05)</option>
<option
  
  value="BZAJAC/Proc-Background-1.09"
>1.09
  (BZAJAC on 2009-07-02)</option>
<option
  
  value="BZAJAC/Proc-Background-1.08"
>1.08
  (BZAJAC on 2002-12-07)</option>
<optgroup label="BackPAN">'
<option
  
  value="NERDVANA/Proc-Background-1.29_02"
>1.29_02 DEV
  (NERDVANA on 2021-10-20)</option>
<option
  
  value="NERDVANA/Proc-Background-1.29_01"
>1.29_01 DEV
  (NERDVANA on 2021-10-20)</option>
<option
  
  value="NERDVANA/Proc-Background-1.21"
>1.21
  (NERDVANA on 2019-11-05)</option>
<option
  
  value="NERDVANA/Proc-Background-1.20"
>1.20
  (NERDVANA on 2019-11-04)</option>
<option
  
  value="BZAJAC/Proc-Background-1.07"
>1.07
  (BZAJAC on 2002-04-21)</option>
<option
  
  value="BZAJAC/Proc-Background-1.06"
>1.06
  (BZAJAC on 2001-09-08)</option>
<option
  
  value="BZAJAC/Proc-Background-1.05"
>1.05
  (BZAJAC on 2001-08-28)</option>
<option
  
  value="BZAJAC/Proc-Background-1.04"
>1.04
  (BZAJAC on 2001-08-16)</option>
<option
  
  value="BZAJAC/Proc-Background-1.03"
>1.03
  (BZAJAC on 2001-02-04)</option>
<option
  
  value="BZAJAC/Proc-Background-1.02"
>1.02
  (BZAJAC on 2001-01-23)</option>
<option
  
  value="BZAJAC/Proc-Background-1.01"
>1.01
  (BZAJAC on 2000-06-21)</option>
<option
  
  value="BZAJAC/Proc-Background-1.00"
>1.00
  (BZAJAC on 2000-04-20)</option>
<option
  
  value="BZAJAC/Proc-Background-0.03"
>0.03
  (BZAJAC on 2000-04-20)</option>
<option
  
  value="BZAJAC/Proc-Background-0.02"
>0.02
  (BZAJAC on 1998-06-28)</option>
<option
  
  value="BZAJAC/Proc-Background-0.01"
>0.01
  (BZAJAC on 1998-06-17)</option>
</optgroup>
</select>
    </li>

    <li>
<ul class="dependencies">
  <li class="nav-header">Dependencies</li>
  <li><i class="ttip" title="dynamic_config enabled">unknown</i></li>
  <li>
    <hr>
  </li>
  <li>
    <a href="https://metacpan.org/module/Proc::Background/requires">Reverse dependencies</a>
  </li>
  <li>
    <a href="http://deps.cpantesters.org/?module=Proc%3A%3ABackground">CPAN Testers List</a>
  </li>
  <li>
    <a href="https://cpandeps.grinnz.com/?dist=Proc-Background">Dependency graph</a>
  </li>
</ul>
    </li>
    <li class="nav-header">Permalinks</li>
    <li>
      <a href="https://metacpan.org/release/NERDVANA/Proc-Background-1.32/view/lib/Proc/Background.pm">This version</a>
    </li>
    <li>
      <a href="./Proc::Background.html">Latest version</a>
    </li>
    <li>
<div class="plussers">
<div class="nav-header">++ed by:</div>
<div>
<a class="display-all" href="https://metacpan.org/author/ESABOL"><img src="https://www.gravatar.com/avatar/539e6f9968426ec02d3370d7654849e2?d=identicon&amp;s=20" title="ESABOL" alt="ESABOL"></a>
<a class="display-all" href="https://metacpan.org/author/JEFFOBER"><img src="https://www.gravatar.com/avatar/ac18a6caf952566dd35e6810ed2b6703?d=identicon&amp;s=20" title="JEFFOBER" alt="JEFFOBER"></a>
</div>
<!-- Display counts of plussers-->
<div>
    <a href="https://metacpan.org/dist/Proc-Background/plussers">2 PAUSE users</a>
</div>
<div>
    5 non-PAUSE users
</div>
</div>
    </li>
    <li>
<div id="metacpan_contributors">
  <div>
    <button class="btn-link"
      onclick="$(this).hide(); $('#metacpan_contributors ul').slideDown(); return false;"
    >and 6 contributors</button>
  </div>
  <ul style="display: none">
    <li class="contributor"
      data-cpan-author="BZAJAC"
      data-contrib-email="blair@orcaware.com"
    >
      <a href="https://metacpan.org/author/BZAJAC" class="cpan-author">
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/6e4d6ed9f60612fae17ddd078fe0d5a5?d=identicon&amp;s=20" />
      Blair Zajac
      </a>
    </li>
    <li class="contributor"
      data-contrib-email="mike@nrdvana.net"
    >
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/d41d8cd98f00b204e9800998ecf8427e?d=identicon&amp;s=20" />
      Michael Conrad
    </li>
    <li class="contributor"
      data-contrib-email="fsfs@debian.org"
    >
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/d41d8cd98f00b204e9800998ecf8427e?d=identicon&amp;s=20" />
      Florian Schlichting
    </li>
    <li class="contributor"
      data-contrib-email="user42@zip.com.au"
    >
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/d41d8cd98f00b204e9800998ecf8427e?d=identicon&amp;s=20" />
      Kevin Ryde
    </li>
    <li class="contributor"
      data-cpan-author="SALVA"
      data-contrib-email="sfandino@yahoo.com"
    >
      <a href="https://metacpan.org/author/SALVA" class="cpan-author">
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/026f1493e8fcd16015467901fa76e9ec?d=identicon&amp;s=20" />
      Salvador Fandiño
      </a>
    </li>
    <li class="contributor"
      data-cpan-author="SKIRMESS"
      data-contrib-email="sven.kirmess@kzone.ch"
    >
      <a href="https://metacpan.org/author/SKIRMESS" class="cpan-author">
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/ca25068048bacb7c0539a0c705b474c4?d=identicon&amp;s=20" />
      Sven Kirmess
      </a>
    </li>
  </ul>
</div>
    </li>
              </ul>
            </div>
          </nav>
          <div class="content-navigation">
<div class="breadcrumbs">
  <span>
    <a data-keyboard-shortcut="g a" rel="author" href="https://metacpan.org/author/NERDVANA" class="author-name">Michael Conrad</a>
  </span>
  <span>&nbsp;/&nbsp;</span>
  <div class="release dist-release status-latest maturity-released">
    <span class="dropdown"><b class="caret"></b></span>
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/lib/Proc/Background.pm&#39;" class="">
<option
  selected
  value="NERDVANA/Proc-Background-1.32"
>1.32
  (NERDVANA on 2023-04-22)</option>
<option
  
  value="NERDVANA/Proc-Background-1.31"
>1.31
  (NERDVANA on 2023-04-17)</option>
<option
  
  value="NERDVANA/Proc-Background-1.30"
>1.30
  (NERDVANA on 2021-10-21)</option>
<option
  
  value="NERDVANA/Proc-Background-1.22"
>1.22
  (NERDVANA on 2021-07-10)</option>
<option
  
  value="BZAJAC/Proc-Background-1.10"
>1.10
  (BZAJAC on 2009-07-05)</option>
<option
  
  value="BZAJAC/Proc-Background-1.09"
>1.09
  (BZAJAC on 2009-07-02)</option>
<option
  
  value="BZAJAC/Proc-Background-1.08"
>1.08
  (BZAJAC on 2002-12-07)</option>
<optgroup label="BackPAN">'
<option
  
  value="NERDVANA/Proc-Background-1.29_02"
>1.29_02 DEV
  (NERDVANA on 2021-10-20)</option>
<option
  
  value="NERDVANA/Proc-Background-1.29_01"
>1.29_01 DEV
  (NERDVANA on 2021-10-20)</option>
<option
  
  value="NERDVANA/Proc-Background-1.21"
>1.21
  (NERDVANA on 2019-11-05)</option>
<option
  
  value="NERDVANA/Proc-Background-1.20"
>1.20
  (NERDVANA on 2019-11-04)</option>
<option
  
  value="BZAJAC/Proc-Background-1.07"
>1.07
  (BZAJAC on 2002-04-21)</option>
<option
  
  value="BZAJAC/Proc-Background-1.06"
>1.06
  (BZAJAC on 2001-09-08)</option>
<option
  
  value="BZAJAC/Proc-Background-1.05"
>1.05
  (BZAJAC on 2001-08-28)</option>
<option
  
  value="BZAJAC/Proc-Background-1.04"
>1.04
  (BZAJAC on 2001-08-16)</option>
<option
  
  value="BZAJAC/Proc-Background-1.03"
>1.03
  (BZAJAC on 2001-02-04)</option>
<option
  
  value="BZAJAC/Proc-Background-1.02"
>1.02
  (BZAJAC on 2001-01-23)</option>
<option
  
  value="BZAJAC/Proc-Background-1.01"
>1.01
  (BZAJAC on 2000-06-21)</option>
<option
  
  value="BZAJAC/Proc-Background-1.00"
>1.00
  (BZAJAC on 2000-04-20)</option>
<option
  
  value="BZAJAC/Proc-Background-0.03"
>0.03
  (BZAJAC on 2000-04-20)</option>
<option
  
  value="BZAJAC/Proc-Background-0.02"
>0.02
  (BZAJAC on 1998-06-28)</option>
<option
  
  value="BZAJAC/Proc-Background-0.01"
>0.01
  (BZAJAC on 1998-06-17)</option>
</optgroup>
</select>
    <a data-keyboard-shortcut="g d" class="release-name" href="https://metacpan.org/dist/Proc-Background">Proc-Background-1.32</a>
  </div>
<span class="river-gauge-gauge">
  <svg width="24px"
       height="15px"
       version="1.1"
       xmlns="http://www.w3.org/2000/svg"
       xmlns:xlink="http://www.w3.org/1999/xlink">

    <g>
      <title>        River stage two &#10;
          • 9 direct dependents &#10;          • 18 total dependents
      </title>

      <rect x="0"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="5"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="10"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="15"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="20"  y="0" width="4" height="15" fill="#e4e2e2" />
    </g>
  </svg>

</span>
<div id="Proc-Background-fav" class="logged_in">
<form action="https://metacpan.org/account/favorite/add" style="display: inline" onsubmit="return favDistribution(this)">
    <input type="hidden" name="remove" value="0">
    <input type="hidden" name="release" value="Proc-Background-1.32">
    <input type="hidden" name="author" value="NERDVANA">
    <input type="hidden" name="distribution" value="Proc-Background">
    <button type="submit" class="favorite highlight"><span>7</span> ++</button>
</form>
</div>
<div class="logged_out">
<a href="./Proc::Background.html" onclick="alert('Please sign in to add favorites'); return false" class="favorite highlight">
<span>7</span> ++</a>
</div>
   / <span>Proc::Background</span>
</div>
          </div>
          <main class="content">


<nav class="toc">
  <div class="toc-header"><strong>Contents</strong></div>
<ul>
  <li><a href="./Proc::Background.html#NAME">NAME</a></li>
  <li><a href="./Proc::Background.html#SYNOPSIS">SYNOPSIS</a></li>
  <li><a href="./Proc::Background.html#DESCRIPTION">DESCRIPTION</a></li>
  <li><a href="./Proc::Background.html#CONSTRUCTOR">CONSTRUCTOR</a></li>
  <li><a href="./Proc::Background.html#ATTRIBUTES">ATTRIBUTES</a></li>
  <li><a href="./Proc::Background.html#METHODS">METHODS</a></li>
  <li><a href="./Proc::Background.html#FUNCTIONS">FUNCTIONS</a></li>
  <li><a href="./Proc::Background.html#BUGS">BUGS</a></li>
  <li><a href="./Proc::Background.html#SEE-ALSO">SEE ALSO</a></li>
  <li><a href="./Proc::Background.html#AUTHORS">AUTHORS</a></li>
  <li><a href="./Proc::Background.html#CONTRIBUTORS">CONTRIBUTORS</a></li>
  <li><a href="./Proc::Background.html#VERSION">VERSION</a></li>
  <li><a href="./Proc::Background.html#COPYRIGHT-AND-LICENSE">COPYRIGHT AND LICENSE</a></li>
</ul></nav>
<div class="pod anchors">
<h1 id="NAME">NAME</h1>

<p>Proc::Background - Generic interface to Unix and Win32 background process management</p>

<h1 id="SYNOPSIS">SYNOPSIS</h1>

<pre><code>  use Proc::Background &#39;timeout_system&#39;;
  timeout_system($seconds, $command, $arg1, $arg2);
  timeout_system($seconds, &quot;$command $arg1 $arg2&quot;);
  
  my $proc1 = Proc::Background-&gt;new($command, $arg1, $arg2) || die &quot;failed&quot;;
  my $proc2 = Proc::Background-&gt;new(&quot;$command $arg1 1&gt;&amp;2&quot;) || die &quot;failed&quot;;
  if ($proc1-&gt;alive) {
    $proc1-&gt;terminate;
    $proc1-&gt;wait;
  }
  say &#39;Ran for &#39; . ($proc1-&gt;end_time - $proc1-&gt;start_time) . &#39; seconds&#39;;
  
  Proc::Background-&gt;new({
    autodie =&gt; 1,           # Throw exceptions instead of returning undef
    cwd =&gt; &#39;some/path/&#39;,    # Set working directory for the new process
    exe =&gt; &#39;busybox&#39;,       # Specify executable different from argv[0]
    command =&gt; [ $command ] # resolve ambiguity of command line vs. argv[0]
  });
  
  # Set initial file handles
  Proc::Background-&gt;new({
    stdin =&gt; undef,                # /dev/null or NUL
    stdout =&gt; &#39;/append/to/fname&#39;,  # will try to open()
    stderr =&gt; $log_fh,             # use existing handle
    command =&gt; \@command,
  });
  
  # Automatically kill the process if the object gets destroyed
  my $proc4 = Proc::Background-&gt;new({ autoterminate =&gt; 1 }, $command);
  $proc4    = undef;  # calls -&gt;terminate</code></pre>

<h1 id="DESCRIPTION">DESCRIPTION</h1>

<p>This is a generic interface for placing processes in the background on both Unix and Win32 platforms. This module lets you start, kill, wait on, retrieve exit values, and see if background processes still exist.</p>

<h1 id="CONSTRUCTOR">CONSTRUCTOR</h1>

<dl>

<dt id="new-[options]-command,-[arg,-[arg,-...]]"><a id="new"></a><a id="new--options--command---arg---arg"></a><b>new</b> [options] <i>command</i>, [<i>arg</i>, [<i>arg</i>, ...]]</dt>
<dd>

</dd>
<dt id="new-[options]-&#39;command-[arg-[arg-...]]&#39;"><a id="new1"></a><a id="new--options---command--arg--arg"></a><b>new</b> [options] &#39;<i>command</i> [<i>arg</i> [<i>arg</i> ...]]&#39;</dt>
<dd>

<p>This creates a new background process. Just like <code>system()</code>, you can supply a single string of the entire command line, or individual arguments. The first argument may be a hashref of named options. To resolve the ambiguity between a command line vs. a single-element argument list, see the <code>command</code> option below.</p>

<p>By default, the constructor returns an empty list on failure, except for a few cases of invalid arguments which call <code>croak</code>.</p>

<p>For platform-specific details, see <a href="https://metacpan.org/pod/Proc::Background::Unix#IMPLEMENTATION">&quot;IMPLEMENTATION&quot; in Proc::Background::Unix</a> or <a href="https://metacpan.org/pod/Proc::Background::Win32#IMPLEMENTATION">&quot;IMPLEMENTATION&quot; in Proc::Background::Win32</a>, but in short:</p>

<dl>

<dt id="Unix">Unix</dt>
<dd>

<p>This implementation uses <code>fork</code>/<code>exec</code>. If you supply a single-string command line, it is passed to the shell. If you supply multiple arguments, they are passed to <code>exec</code>. In the multi-argument case, it will also check that the executable exists before calling <code>fork</code>.</p>

</dd>
<dt id="Win32">Win32</dt>
<dd>

<p>This implementation uses the <a href="./Win32::Process.html#METHODS">Windows CreateProcess API</a>. If you supply a single-string command line, it derives the executable by parsing the command line and looking for the first element in the <code>PATH</code>, appending <code>&quot;.exe&quot;</code> if needed. If you supply multiple arguments, the first is used as the <code>exe</code> and the command line is built using <a href="https://metacpan.org/pod/Win32::ShellQuote">Win32::ShellQuote</a>. To let Windows search for the executable, pass option <code>{ exe =&gt; undef }</code>.</p>

</dd>
</dl>

<p><b>Options:</b></p>

<dl>

<dt id="autodie"><code>autodie</code></dt>
<dd>

<p>This module traditionally has returned <code>undef</code> if the child could not be started. Modern Perl recommends the use of exceptions for things like this. This option, like Perl&#39;s <a href="https://metacpan.org/pod/autodie">autodie</a> pragma, causes all fatal errors in starting the process to die with exceptions instead of returning undef. (module-usage errors or other problems prior to launching the process may still &#39;croak&#39; regardless of this setting)</p>

</dd>
<dt id="command"><code>command</code></dt>
<dd>

<p>You may specify the command as an option instead of passing the command as a list. A string value is considered a command line, and an arrayref value is considered an argument list. Using this option resolves the ambiguity in the plain-list constructor between a command line vs. a single-element argument list.</p>

</dd>
<dt id="exe"><code>exe</code></dt>
<dd>

<p>Specify the executable. This can serve two purposes: on Win32 it avoids the need to parse the commandline, and on Unix it can be used to run an executable while passing a different value for <code>$ARGV[0]</code>.</p>

</dd>
<dt id="stdin,-stdout,-stderr"><a id="stdin"></a><a id="stdin--stdout--stderr"></a><code>stdin</code>, <code>stdout</code>, <code>stderr</code></dt>
<dd>

<p>Specify one or more overrides for the standard handles of the child. The value should be a Perl filehandle with an underlying system <code>fileno</code> value. As a convenience, you can pass <code>undef</code> to open the <code>NUL</code> device on Win32 or <code>/dev/null</code> on Unix. You may also pass a plain-scalar file name which this module will attmept to open for reading or appending.</p>

<p>(for anything more elaborate, see <a href="./IPC::Run.html">IPC::Run</a> instead)</p>

<p>Note that on Win32, none of the parent&#39;s handles are inherited by default, which is the opposite on Unix. When you specify any of these handles on Win32 the default will change to inherit the rest from the parent.</p>

</dd>
<dt id="cwd"><code>cwd</code></dt>
<dd>

<p>Specify a path which should become the child process&#39;s current working directory. The path must already exist.</p>

</dd>
<dt id="autoterminate"><code>autoterminate</code></dt>
<dd>

<p>If you pass a true value for this option, then destruction of the Proc::Background object (going out of scope, or script-end) will kill the process via <code>-&gt;terminate</code>. Without this option, the child process continues running. <code>die_upon_destroy</code> is an alias for this option, used by previous versions of this module.</p>

</dd>
</dl>

</dd>
</dl>

<h1 id="ATTRIBUTES">ATTRIBUTES</h1>

<dl>

<dt id="command1"><b>command</b></dt>
<dd>

<p>The command (string or arrayref) that was passed to the constructor.</p>

</dd>
<dt id="exe1"><b>exe</b></dt>
<dd>

<p>The path to the executable that was passed as an option to the constructor, or derived from the <code>command</code>.</p>

</dd>
<dt id="start_time"><b>start_time</b></dt>
<dd>

<p>Return the value that the Perl function time() returned when the process was started.</p>

</dd>
<dt id="pid"><b>pid</b></dt>
<dd>

<p>Returns the process ID of the created process. This value is saved even if the process has already finished.</p>

</dd>
<dt id="alive"><b>alive</b></dt>
<dd>

<p>Return 1 if the process is still active, 0 otherwise. This makes a non-blocking call to <code>wait</code> to check the real status of the process if it has not been reaped yet.</p>

</dd>
<dt id="suspended"><b>suspended</b></dt>
<dd>

<p>Boolean whether the process is thought to be stopped. This does not actually consult the operating system, and just returns the last known status from a call to <code>suspend</code> or <code>resume</code>. It is always false if <code>alive</code> is false.</p>

</dd>
<dt id="exit_code"><b>exit_code</b></dt>
<dd>

<p>Returns the exit code of the process, assuming it exited cleanly. Returns <code>undef</code> if the process has not exited yet, and 0 if the process exited with a signal (or TerminateProcess). Since 0 is ambiguous, check for <code>exit_signal</code> first.</p>

</dd>
<dt id="exit_signal"><b>exit_signal</b></dt>
<dd>

<p>Returns the value of the signal the process exited with, assuming it died on a signal. Returns <code>undef</code> if it has not exited yet, and 0 if it did not die to a signal.</p>

</dd>
<dt id="end_time"><b>end_time</b></dt>
<dd>

<p>Return the value that the Perl function time() returned when the exit status was obtained from the process.</p>

</dd>
<dt id="autoterminate1"><b>autoterminate</b></dt>
<dd>

<p>This writeable attribute lets you enable or disable the autoterminate option, which could also be passed to the constructor.</p>

</dd>
</dl>

<h1 id="METHODS">METHODS</h1>

<dl>

<dt id="wait"><b>wait</b></dt>
<dd>

<pre><code>  $exit= $proc-&gt;wait; # blocks forever
  $exit= $proc-&gt;wait($timeout_seconds); # since version 1.20</code></pre>

<p>Wait for the process to exit. Return the exit status of the command as returned by wait() on the system. To get the actual exit value, divide by 256 or right bit shift by 8, regardless of the operating system being used. If the process never existed, this returns undef. This function may be called multiple times even after the process has exited and it will return the same exit status.</p>

<p>Since version 1.20, you may pass an optional argument of the number of seconds to wait for the process to exit. This may be fractional, and if it is zero then the wait will be non-blocking. Note that on Unix this is implemented with <a href="https://metacpan.org/pod/Time::HiRes#alarm">&quot;alarm&quot; in Time::HiRes</a> before a call to wait(), so it may not be compatible with scripts that use alarm() for other purposes, or systems/perls that resume system calls after a signal. In the event of a timeout, the return will be undef.</p>

</dd>
<dt id="suspend"><b>suspend</b></dt>
<dd>

<p>Pause the process. This returns true if the process is stopped afterward. This throws an excetion if the process is not <code>alive</code> and <code>autodie</code> is enabled.</p>

</dd>
<dt id="resume"><b>resume</b></dt>
<dd>

<p>Resume a paused process. This returns true if the process is not stopped afterward. This throws an exception if the process is not <code>alive</code> and <code>autodie</code> is enabled.</p>

</dd>
<dt id="terminate,-terminate(@kill_sequence)"><a id="terminate"></a><a id="terminate--terminate-kill_sequence"></a><b>terminate</b>, <b>terminate(@kill_sequence)</b></dt>
<dd>

<p>Reliably try to kill the process. Returns 1 if the process no longer exists once <b>terminate</b> has completed, 0 otherwise. This will also return 1 if the process has already exited.</p>

<p><code>@kill_sequence</code> is a list of actions and seconds-to-wait for that action to end the process. The default is <code> TERM 2 TERM 8 KILL 3 KILL 7 </code>. On Unix this sends SIGTERM and SIGKILL; on Windows it just calls TerminateProcess (graceful termination is still a TODO).</p>

<p>Note that <code>terminate()</code> (formerly named <code>die()</code>) on Proc::Background 1.10 and earlier on Unix called a sequence of:</p>

<pre><code>  -&gt;die( ( HUP =&gt; 1 )x5, ( QUIT =&gt; 1 )x5, ( INT =&gt; 1 )x5, ( KILL =&gt; 1 )x5 );</code></pre>

<p>which wasn&#39;t what most people need, since SIGHUP is open to interpretation, and QUIT is almost always immediately fatal and generates a coredump. The new default should accomodate programs that acknowledge a second SIGTERM, and give enough time for it to exit on a laggy system while still not holding up the main script too much.</p>

<p><code>die</code> is preserved as an alias for <code>terminate</code>.</p>

<p>This throws an exception if the process has been reaped and <code>autodie</code> is enabled.</p>

</dd>
</dl>

<h1 id="FUNCTIONS">FUNCTIONS</h1>

<dl>

<dt id="timeout_system-timeout,-command,-[arg,-[arg...]]"><a id="timeout_system"></a><a id="timeout_system-timeout--command---arg---arg"></a><b>timeout_system</b> <i>timeout</i>, <i>command</i>, [<i>arg</i>, [<i>arg</i>...]]</dt>
<dd>

</dd>
<dt id="timeout_system-&#39;timeout-command-[arg-[arg...]]&#39;"><a id="timeout_system1"></a><a id="timeout_system--timeout-command--arg--arg"></a><b>timeout_system</b> &#39;<i>timeout</i> <i>command</i> [<i>arg</i> [<i>arg</i>...]]&#39;</dt>
<dd>

<p>Run a command for <i>timeout</i> seconds and if the process did not exit, then kill it.</p>

<p>In a scalar context, <b>timeout_system</b> returns the exit status from the process. In an array context, <b>timeout_system</b> returns a two element array, where the first element is the exist status from the process and the second is set to 1 if the process was killed by <b>timeout_system</b> or 0 if the process exited by itself.</p>

<p>The exit status is the value returned from the wait() call. If the process was killed, then the return value will include the killing of it. To get the actual exit value, divide by 256.</p>

<p>If something failed in the creation of the process, the subroutine returns an empty list in a list context, an undefined value in a scalar context, or nothing in a void context.</p>

</dd>
</dl>

<h1 id="BUGS">BUGS</h1>

<p>The following behaviors aren&#39;t ideal, but are preserved for backward-compatibility.</p>

<dl>

<dt id="Commandline-vs.-Single-Argv[]"><a id="Commandline"></a><a id="Commandline-vs.-Single-Argv"></a>Commandline vs. Single Argv[]</dt>
<dd>

<p><code>-&gt;new($x)</code> is treated as a command line. In <code>-&gt;new({ exe =&gt; $y }, $x)</code>, $x is treated as <code>$ARGV[0]</code>. Use <code>-&gt;new({ command =&gt; ... })</code> (scalar vs. arrayref) to dis-ambiguate.</p>

</dd>
<dt id="Win32-Argv-Quoting"><a id="Win321"></a>Win32 Argv Quoting</dt>
<dd>

<p>This is a bug in Windows, not this module. It is not possible to universally convert an @ARGV into a commandline, because each Win32 program performs its own command line parsing, and cmd.exe and find.exe deviate from the majority of other executables. Those things could be improved with hieuristics, which this module doesn&#39;t have.</p>

</dd>
<dt id="Win32-exe-determination"><a id="Win322"></a>Win32 exe determination</dt>
<dd>

<p>If you don&#39;t specify an absolute path for option <code>exe</code>, this module manually searches the %PATH% looking for the executable, and is less thorough than the native Windows shell behavior. Use <code>{ exe =&gt; undef }</code> to get the naive Windows exe search. (but you need Win32::Process version 0.17 or newer)</p>

</dd>
<dt id="Win32-SIGTERM"><a id="Win323"></a>Win32 SIGTERM</dt>
<dd>

<p>This module only supports TerminateProcess, which is equivalent to SIGKILL, not SIGTERM. SIGTERM could be emulated by calling taskkill.exe, or using windows messages. Patches welcome.</p>

</dd>
</dl>

<h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1>

<dl>

<dt id="IPC::Run"><a id="IPC"></a><a href="./IPC::Run.html">IPC::Run</a></dt>
<dd>

<p>IPC::Run is a much more complete solution for running child processes. It handles dozens of forms of redirection and pipe pumping, and should probably be your first stop for any complex needs.</p>

<p>However, also note the very large and slightly alarming list of limitations it lists for Win32. Proc::Background is a much simpler design and should be more reliable for simple needs.</p>

</dd>
<dt id="Win32::ShellQuote"><a id="Win324"></a><a href="https://metacpan.org/pod/Win32::ShellQuote">Win32::ShellQuote</a></dt>
<dd>

<p>If you are running on Win32, this article by Daniel Colascione helps describe the problem you are up against for passing argument lists: <a href="https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/">Everyone quotes command line arguments the wrong way</a></p>

<p>This module gives you parsing / quoting per the standard CommandLineToArgvW behavior. But, if you need to pass arguments to be processed by <code>cmd.exe</code> then you need to do additional work.</p>

</dd>
</dl>

<h1 id="AUTHORS">AUTHORS</h1>

<ul>

<li><p>Blair Zajac &lt;blair@orcaware.com&gt;</p>

</li>
<li><p>Michael Conrad &lt;mike@nrdvana.net&gt;</p>

</li>
</ul>

<h1 id="CONTRIBUTORS">CONTRIBUTORS</h1>

<ul>

<li><p>Florian Schlichting &lt;fsfs@debian.org&gt;</p>

</li>
<li><p>Kevin Ryde &lt;user42@zip.com.au&gt;</p>

</li>
<li><p>Salvador Fandi&ntilde;o &lt;sfandino@yahoo.com&gt;</p>

</li>
<li><p>Sven Kirmess &lt;sven.kirmess@kzone.ch&gt;</p>

</li>
</ul>

<h1 id="VERSION">VERSION</h1>

<p>version 1.32</p>

<h1 id="COPYRIGHT-AND-LICENSE"><a id="COPYRIGHT"></a>COPYRIGHT AND LICENSE</h1>

<p>This software is copyright (c) 2023 by Michael Conrad, (C) 1998-2009 by Blair Zajac.</p>

<p>This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.</p></div>

<div id="metacpan_install-instructions-dialog" class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Module Install Instructions</h4>
      </div>
      <div class="modal-body">
        <p>To install Proc::Background, copy and paste the appropriate command in to your terminal.</p>
        <p><a href="https://metacpan.org/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p>
        <pre><code>cpanm Proc::Background</code></pre>
        <p><a href="https://metacpan.org/pod/CPAN">CPAN shell</a></p>
        <pre><code>perl -MCPAN -e shell
install Proc::Background</code></pre>
        <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p>
      </div>
      <div class="modal-footer">
        <a href="./Proc::Background.html#" data-dismiss="modal" class="btn">Close</a>
      </div>
    </div>
  </div>
</div>
          </main>
          <div class="content-pagination">
          </div>
        </div>
        <footer class="footer">
          <div class="footer-container">
            <div class="footer-social">
              <div class="footer-link footer-logo">
                <a href="https://metacpan.org/">
                  <img src="https://metacpan.org/static/images/metacpan-logo.svg" alt="MetaCPAN" />
                </a>
              </div>
              <a class="footer-social-link" href="https://github.com/metacpan">
                <i class="fab fa-github-square"></i>
              </a>
              <a class="footer-social-link" href="https://fosstodon.org/@metacpan">
                <i class="fab fa-mastodon"></i>
              </a>
            </div>
            <div class="footer-links">
              <div class="footer-link">
                  <a href="https://metacpan.org/about">About</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/sponsors">Sponsor</a>
              </div>
              <div class="footer-link">
                  <a href="https://grep.metacpan.org">grep::cpan</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/recent">Recent</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/faq">FAQ</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/tools">Tools</a>
              </div>
              <div class="footer-link">
                  <a href="https://fastapi.metacpan.org/">API</a>
              </div>
              <div class="footer-link">
                  <a href="https://www.perl.org/">Perl.org</a>
              </div>
            </div>
            <div class="footer-sponsors">
              <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener">
                <img class="footer-sponsor-bytemark" src="https://metacpan.org/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener">
                <img class="footer-sponsor-liquidweb" src="https://metacpan.org/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener">
                <img class="footer-sponsor-deriv" src="https://metacpan.org/static/images/sponsors/deriv.svg" alt="Deriv logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener">
                <img class="footer-sponsor-geocode" src="https://metacpan.org/static/images/sponsors/geocodelogo.svg" alt="Geocode logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener">
                <img class="footer-sponsor-fastly" src="https://metacpan.org/static/images/sponsors/fastly_logo.svg" alt="Fastly logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener">
                <img class="footer-sponsor-opencage" src="https://metacpan.org/static/images/sponsors/open-cage.svg" alt="OpenCage logo">
              </a>
            </div>
          </div>
        </footer>
        <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts">
          <div class="modal-dialog">
            <div class="modal-content">
              <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal">&times;</button>
                <h4 class="modal-title">Keyboard Shortcuts</h4>
              </div>
              <div class="modal-body row">
<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Global</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>s</kbd>
        </td>
        <td>Focus search bar</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>?</kbd>
        </td>
        <td>Bring up this help dialog</td>
      </tr>
    </tbody>
  </table>

  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>GitHub</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>p</kbd>
        </td>
        <td>Go to pull requests</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>go to github issues (only if github is preferred repository)</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>POD</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>a</kbd>
        </td>
        <td>Go to author</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>c</kbd>
        </td>
        <td>Go to changes</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>Go to issues</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>d</kbd>
        </td>
        <td>Go to dist</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>r</kbd>
        </td>
        <td>Go to repository/SCM</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>s</kbd>
        </td>
        <td>Go to source</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>b</kbd>
        </td>
        <td>Go to file browse</td>
      </tr>

    </tbody>
  </table>
</div>

<div class="col-md-12">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Search terms</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><em>module:</em> (e.g. <a href="https://metacpan.org/search?q=module%3APlugin">module:Plugin</a>)</td>
      </tr>
      <tr>
        <td><em>distribution:</em> (e.g. <a href="https://metacpan.org/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td>
      </tr>
      <tr>
        <td><em>author:</em> (e.g. <a href="https://metacpan.org/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td>
      </tr>
      <tr>
        <td><em>version:</em> (e.g. <a href="https://metacpan.org/search?q=version%3A1.00">version:1.00</a>)</td>
      </tr>
    </tbody>
  </table>
</div>
              </div>
              <div class="modal-footer"></div>
            </div>
          </div>
        </div>
    </body>
</html>
